Amiga Collections: Auge 4000/Auge 4000 #44 (1990-05-04)(Amiga User Gruppe Einzugsgebiet 4000).zip/Auge 4000 #44 (1990-05-04)(Amiga User Gruppe Einzugsgebiet 4000).adf/Anwendungen/sid/SID.doc

Text File | 1990-05-01 | 83KB | 1,772 lines

               SID DOCS : "Break Glass In Case of Emergency"

A PROGRAMMER`S PLEA: -------------------------------------------------------
SID is shareware.If you find this program useful,please send $25 to:

                              Timm Martin
                              P.O. Box 10084
                              Largo, FL  34643

You may adjust that figure if you feel that it`s too high or low.Even if you
think that  SID stinks, I would appreciate a nasty (but constructive) letter
telling me how I can improve it.Please promote the sharewaresystem by making
a contribution to the authors of the shareware products you commonly use.Th-
ere are many advantages to the shareware system:
- You can receive quality programs at a decent price.Had this been a commer-
  cial program,you could expect to pay at least $49.95.
- You can thoroughly examine a shareware program before reimbursing the aut-
  hor.Once you've purchased a commercial program,you're stuck with it.
- You promote the creation of a number of exciting and diverse programs that
  would otherwise not reach the  public if commercial marketing was the only
  alternative.

Along with your $25,please send your name,address, and the version number of
SID that you are currently using.This can be found by displaying the Inform-
ationrequester located in the Program menu.In return,all registered SIDusers
will receive the most recent  version of SID, any available support programs
(such as the planned interactive configuration editor),the most recent vers-
ion of the manuals,a set of  update docs which describe  the changes made in
each SID update,and a number of other Software Ingenuity public domain prog-
rams and utilities.

Registered users will also receive timely  announcements of major future up-
grades.These upgrades can be acquired long before their national release for
only $3 each,or for free if you send an Amiga diskette and a stamped (65 ce-
nts postage),self-addressed envelope  or diskette mailer. Software Ingenuity
cannot be held responsible for lost or damaged mail,so a mailer is recommen-
ded.As an additional bonus,registered SID users will be able to download the
most recent version of  SID from the  Software Ingenuity Electronic Bulletin
Board.Each new version of SID will be  made available to registered users at
least one month before it is released nationally.You can also ask questions,
give suggestions,or submit bug reports. Complete details`ll be mailed to you
when you send in your shareware fee.

A QUICK HISTORY: -----------------------------------------------------------
SID has been in development since October 1988,and has undergone nine months
of rigorous testing by over a dozen people.After 26 updates,1 complete rewr-
ite,hundreds of hours of work,and over 513,810 bytes of C and assembler code
spread over 77 modules,SID has emerged into what I hope you find is the best
directory utility available for the Commodore Amiga. I welcome any comments,
suggestions,or complaints that you  may have about SID. It was the excellent
suggestions from my beta-testers that made SID great in the first place, and
I'm always looking for ways to improve SID.Personal replies to your comments
can be obtained by including a self-addressed, stamped envelope.

There are a number of people I'd like to  thank for helping me make SID what
it is today:

Elaine Martin:
For her patience,understanding,and the world's  best chocolate chip cookies.
Without her as the lifeblood of my existence  SID would never have been pos-
sible.

Jeff Hoag:
For his great ideas,beta-testing,and advice for boosting my spirits when th-
ey needed boosting; and for letting me win the RC car races, even though his
car was clearly faster.

Mike Monaco (Dr. Assembler):
For his pattern matching state machine,68000 assembler help,and combat bask-
etball games ("it's not a foul unless you strike blood") that helped me rele
ase some of that programming stress.

Jimbo Barber:
For his great ideas,continuous bug reports, and for being my biggest critic.
I really had to bust my ass to please him.

John Ruckart (SYSOP of the Tsunami Wave BBS):
For giving me my SID section on the Wave  so that it could be properly beta-
tested,dissected,and analyzed;and for being  my first shareware contributor,
long before SID was officially released.

David Head:
For finding source code when  I needed it, and for his excellent suggestions
in the later hours of SID development.

I'd also like to thank my other beta-testers for their suggestions,comments,
and support through the development of SID:  Fabbian Dufoe,Dave Fournier,Tom
Fredericks,Scott Fry,Allen Maroney,Ed Paquette,Mark Weddell.

DISCLAIMER: ----------------------------------------------------------------
SID is provided "AS IS" without warranty of any kind,either expressed or imp
lied. By using SID,you agree to accept the entire risk as to the quality and
performance of the program.Any liability of Software Ingenuity will be limi-
ted exclusively to product replacement.

MY LAWYER TELLS ME I NEED THIS: --------------------------------------------
Now,for the legal stuff.You don't need to read this unless you plan on uplo-
ading,distributing,marketing,or stealing SID...

                   SID is © Copyright 1989 by Timm Martin
                     All Rights are Reserved Worldwide

SID is  freely distributable as  long as all of the following conditions are
met: All of the files must be included in their original form without addit-
ions,deletions,or modifications of any kind.Any such modifications must app-
ear in separate files. All copyright notices must remain intact. SID may not
be sold commercially alone or as a component in another product. SID may not
appear on shareware or public domain disks for which the consumers are char-
ged more than a nominal disk copying fee of six dollars (US $6) per disk.SID
may not appear on any  electronic service which  charges more than the basic
access fee to download SID.SID may not appear on any electronic service that
claims copyrights to uploaded programs,either alone or as part of a collect-
ion.If you would like a variance to any of the above conditions,please cont-
act me for written permission.

WHERE TO REACH ME:
For comments or information on SID or other Software Ingenuity products,plea
se write or call us at:

                          Software Ingenuity
                          11325 94th Street North
                          P.O. Box 10084
                          Largo, Florida  34643
                          [phone]

RUNNING SID: ---------------------------------------------------------------
From the Workbench: Double click on the SID icon.
From the CLI      : Enter in the CLI window: SID [dir1 [dir2]]

If specified,"dir1" and "dir2" will be loaded in the directorylists.Specify-
ing -c will load the current dir. SID detaches from the CLI,meaning that you
can close the  CLI window after running SID  by entering "endcli" in the CLI
window.

WINDOW GADGETS: ------------------------------------------------------------
Stop Gadget,Depth Gadgets,Drag Bar:
These operate as you would expect them to.The DragBar does not appear in the
SID window when it opens on its own custom screen.

Sizing Gadget:
Can only be used to size the window when SID is sleeping (ZZ pointer is vis-
ible) to allow you to reach icons on the Workbench screen.When SID reawakens
it will reopen its window at the previous size.

DIRECTORY LISTS: -----------------------------------------------------------
NOTE: When I speak of the Workbench screen colors,I am speaking of the stan-
dard Workbench screen colors set by Commodore.They are:

                             Blue ..... Color 0
                             White .... Color 1
                             Black .... Color 2
                             Orange ... Color 3

Active (or Source) List:
Denoted by orange highlighting above and below the list.All commands operate
on highlighted files in the active list.

Inactive (or Destination) List:
No orange lines.This is the destination list for two-directory commands(such
as COPY and MOVE).

Can select the active list by
- Clicking the left mouse button on the list.Will also highlight/unhighlight
  any directory entries.
- Clicking the right mouse button  (RMB) anywhere in the window. The list on
  the side of the window where you click becomes the activelist.If you click
  the RMB above the lists,the menus will activate.
- Clicking on the corresponding arrow gadgets,slider bar,parent gadget,or re
  highlight gadget. Check out SID.iff to see where these gadgets are located
  in the SID window.

DIRECTORY ENTRIES: ---------------------------------------------------------
Files:
Highlighted .... white letters on black background
Unhighlighted .. black letters on white background

Directories:
Highlighted .... orange letters on black background
Unhighlighted .. black letters on orange background

To highlight an entry,click the left mouse button (LMB) on the desired entry
You can (un)highlight multiple entries  by holding the button + dragging the
mouse.The list will scroll when you move the pointer above or below the list
To unhighlight an entry, just click on it again.

DIRECTORY GADGETS: ---------------------------------------------------------
Up Arrow Gadget:
Click once to display the previous entry.Click and hold to scroll.

Down Arrow Gadget:
Click once to display the next entry.Click and hold to scroll.

Once you've clicked on an arrow gadget,hold the LMB and move the pointer off
the gadget. The list will continue to scroll. As you move the pointer toward
the vertical center of the list, the scroll`ll slow down until the direction
reverses when you pass the center.You can also scroll the file list by clic-
king the RMB while the pointer  is over the list. Moving the pointer up will
scroll the list up,and moving the pointer down will scroll the list down.The
scrolling slows down as the pointer moves  toward the vertical center of the
list.Stop the scroll by releasing the right mouse button.

Slider Bar:
Click once to page forward or backward.Click and hold to scroll.

Parent Gadget:
A tall,skinny gadget hidden in the window border next to each list. Click on
it to load the parent of the current directory.

Rehighlight Gadget:
Hidden to the left and right of  the command gadgets. Will highlight entries
highlighted before the execution of the previous command. Any entries you've
highlighted so far will remain highlighted.

Path Field:
Located above each directory list,the PathField contains the name of the dir
To manually enter a path name,click the LMB in it,type the name of the path,
and press RETURN.Or press ESCape to get rid of the cursor. Can return cursor
to the Path Field by pressing the left arrow for the left field, right arrow
for the right field.Pressing ENTER in a blank path field will load the curr-
ent directory.

Previous Directory Gadget:
Hidden in the window border next to each path field. Clicking on this gadget
will load the previous directory for this list.This is handy when you accide
ntally wipe out the current directory by loading another directory. Click on
this gadget, and the previous dir will be reloaded. You can also use this to
toggle back and forth between two directories.

Field Editing:
The fields in SID are not Intuition stringgadgets,but rather,a modified form
of SmartFieldsII by Software Ingenuity.Because of this,there are a number of
powerful editing features that are not found in regular string gadgets:

Cursor Movement:
          Left Arrow .......... to the previous character
          Right Arrow ......... to the next character
          SHIFT Left Arrow .... to the beginning of the previous word
          SHIFT Right Arrow ... to the beginning of the next word
          ALT Left Arrow ...... to the beginning of the field
          ALT Right Arrow ..... to the end of the field
          TAB ................. jump right
          SHIFT TAB ........... jump left

Field Editing:
          DELete ...... delete character under cursor
          BACKSPACE ... delete character to left of cursor
          CTRL-X ...... delete entire field contents
          CTRL-R ...... restore deleted contents
          CTRL-F ...... delete forward
          CTRL-B ...... delete backward

Clipboard Commands:
          CTRL-C ..... copy field contents to clip
          CTRL-K ..... cut field contents to clip
          CTRL-P ..... paste clip contents into field

Miscellaneous Commands:
          CTRL-I ..... place in insert mode
          CTRL-T ..... place in typeover mode
          RETURN ..... accept data in field
          ESCape ..... stop current command

As you can see above,SID maintains its own private clipboard,allowing you to
transfer data between fields.You can also adjust the TAB jump by pressing CT
RL-TAB then the number of spaces between 1 and 9.For example,CTRL-TAB then 5
will set the TAB jump to five spaces.

The standard Intuition string gadget editing keys are also supported.Press:

             Right-Amiga-X ... to delete entire field contents
             Right-Amiga-Q ... to restore deleted contents

DIRECTORY MESSAGES: --------------------------------------------------------
Message Box:
Bottom of the window.All SID messages are displayed here.

Directory Message:
Displayed every time an active side is selected.For example:

        001/023 Files 002/004 Dirs 6.3K Free

The numbers in the above example are:
001 .. (white) ... number of highlighted files
023 .. (white) ... total number of files
002 .. (orange) .. number of highlighted directories
004 .. (orange) .. total number of directories
6.3 .. (black) ... approximate number of bytes free on the corresponding de-
                   vice,listed in KB or MB,whichever is appropriate

LOADING DIRECTORIES: -------------------------------------------------------
In same list:
To load one of the directories listed,double click on it.

In the other list...Explore Gadget:
Click on the arrow (the Explore Gadget) located in the center of the window.
It turns orange to indicate "Explore Mode".Every dir you click on in the ac-
tive list will be loaded in the inactive list.Click on it again to stop Exp-
lore Mode.

DEVICE GADGETS: ------------------------------------------------------------
Two identical sets of ten gadgets located immediately under each list.The ei
ght on the left of each  set are named after  different devices which may be
found on your system.The remaining two are the VOL and DIR gadgets.

Device Gadgets:
Originally configured as DF0 DF1 RAM RAD DH0 DH1 DH2 DH3. Clicking on one of
these will activate  the list above the gadget and load the directory of the
selected device in that list.

You can also specify an alternate path to be loaded when you click on a dev-
ice gadget.That way you can give the device gadgets more meaningful names su
ch as WKB for Workbench instead of the generic DH0.See the "Button= keyword"
in the ConfigDocs for more details.

VOLume Gadget:
Will load the names of all mounted volumes on  your system in the list above
the gadget. This not only includes physical  volumes (disks in drives / hard
disk partitions),but logical volumes (created with the AmigaDOS `Assign` com
mand) as well.

DIR Gadget:
Will reload the same directory listed in the PathField above the gadget.This
is equivalent to  clicking the cursor in one of the Path Fields and pressing
RETURN.Since SID does`nt reload the directory after each command,it only kn-
ows about directory changes  that it has made.If you suspect another program
has changed the directory listed (by adding or deleting files),click on this
button to reload it. If the Path Field is empty,clicking on the DIRgadget`ll
load the current directory.


STOP! REQUESTER:
The white STOP! Requester appears in the middle of the SID window during the
execution of each command.The window's sizing gadget works when the STOP!re-
quester is in the window.

STOP! Gadget:
Click on this to terminate  the current command. All highlighted files which
have not been affected yet by the command will remain highlighted.

PAUSE Gadget:
Click on this to pause the current command.The gadget then becomes the RESU-
ME Gadget which you click on to resume the command.

One convenient feature  about the STOP! Requester is you can  select a large
dir,click on STOP! as it begins to load, then copy or move files to it, load
its parent,or get DISKinformation about it. You can perform these operations
without having to wait for the entire directory to load.

WINDOW SIZES: --------------------------------------------------------------
There are three standard window sizes:

Half Size - 640 pixels wide by 104 pixels high ( 3 files visible)
Full Size - 640 pixels wide by 200 pixels high (15 files visible)
Lace Size - 640 pixels wide by 384 pixels high (38 files visible)

You can select these sizes with the "Window" item in the "Environment" menu.
A check mark will appear next to the current size.

Specify Size:
You specify the size of the window based on the number of files that are vi-
sible in  each list at one time  (also referred to as the number of rows). A
requester will appear asking you to enter the number of rows desired.It will
list the minimum,current,and maximum number of rows possible. SID will allow
you to open a window as large as possible.Using VScreen,a public domain uti-
lity by Davide P. Cervone,you can open a SIDwindow that's 118 rows tall on a
1024-pixel-high Workbench screen!

Shrink Window:
The SIDwindow will iconify itself when you click on the SHRINK Gadget in the
upper right corner of the window.Clicking on the EXPAND Gadget in the iconi-
fied window will return the SID window to its original size.

SCREENS: -------------------------------------------------------------------
Workbench Screen:
To save memory

Custom Screen:
SID's own highresolution NONinterlaced custom screen.The position of the SID
window is fixed in the screen.Move the SIDwindow in and out of view with the
screen's drag bar and depth gadgets.

Interlace Screen:
SID's own highresolution interlaced custom screen.The position of the SIDwin
dow is fixed in the screen. Move the SID  window in and out of view with the
screen's drag bar and depth gadgets.

ENTRY DISPLAY:
You can change the format of the file and dir entry display with the Display
item in the "Environment" menu.You can choose from:

Size Only   <--------- FileName ---------->9999999
Date/Time   <--------- FileName ---------->9999999  MM/DD/YY  HH:MM:SSam
Description <--------- FileName ---------->9999999  <-- Description --->

where:

FileName ..... is the name of the file or directory
9999999 ...... is the size of the file in bytes (not listed for dirs)
MM/DD/YY ..... is the creation date of the file in month/day/year format
HH:MM:SSam ... is the creation time of the file in hours:minutes:seconds
Descrition ... is SID's identification of the file

A checkmark appears next to the format used.Both dirs reload when you choose
another format.The "Size Only" format provides the fastest directory loads.

FILE DESCRIPTION:
SID can currently identify a number of files on the Amiga:

AmigaBASIC program
ARC file
Assignment ........... logical device created with Assign command
Directory
Executable Object .... program, library, etc.
Font Header
IFF Graphic
IFF Sound
IFF Music
IFF Text
.info Icon ........... Workbench icon image file
Lattice Object
Manx Object
Maxiplan Spreadsheet
PageStream Document
PAK file
ProPage Document
Superbase File Defn
Superbase Query
Volume ............... diskette, hard disk partition
WARP file
WordPerfect Text
ZOO file

If SID cannot identify an  entry as one of the above, it will classify it as
either an ASCII File or Binary File depending on whether any binary is found
in the file.International characters are considered to be ASCII characters.

DOUBLE CLICKING: -----------------------------------------------------------
Double clicking on a file`ll attempt to execute  the proper command for that
file.This is handy when you`re highlighting a number of entries and you want
to check out a single entry without looking at all the other entries.The com
mands executed are:

ARC File ........... LISTARC
ASCII File ......... READ
IFF Graphic ........ VIEW
IFF Sound .......... HEAR
WordPerfect Text ... READ
ZOO File ........... LISTARC
all others ......... INFO

Note that because PAK and WARP do not support  LISTARC yet,the INFO command
will be executed for these files.

OUTPUT: -------------------------------------------------------------------
When you run SID,it opens a 1x1 pixel CLIwindow in the upper left corner of
the Workbench screen. This catches the output from any program you run from
SID without clicking on the OUTPUT gadget.AmigaDOS doesn't like it when th-
ere's nowhere to send a program's output, and your program`ll crash without
it.Before running,however,SID checks to see if the NULL: device is mounted.
If it is,it uses the NULL: device for program output,and the 1x1 pixel win-
dow is not opened. This saves you about 5K in memory,plus some system over-
head that Intuition needs to maintain the output window.To use the NULL: de
vice,copy the  supplied "null-handler" file into your L: directory, and add
the supplied "MountList" entry to your devs:MountList file. Then be sure to
"mount null:" sometime before running SID.If you plan on using this on a re
gular basis,you might want to put the mountcommand in your startup-sequence
Note that SID does NOT require the NULL:device to run.It is merely provided
for those users who wish  to save a little memory and system overhead. Many
new programs including RunBack are  using the NULL: device as a replacement
for NIL:(NIL: is not a real device and therefore cannot be used by programs
which require a real device for output).

PROGRAM MENU: -------------------------------------------------------------
Configuration:
Nearly every feature in SID is configurable.A set of defaults are hardwired
into the program making SID usable by itself,but if your system environment
or personal tastes  differ from mine, you will need a config file to change
these defaults.See the "ConfigDocs" part for more information.

Edit:
Allows you to edit the configfile with the text editor you specified to use
with the EDIT command.

Load:
Loads the configuration file.

Information:
Displays an information  requester about SID. The program version number is
found here.

Last Error:
Explains the meaning of the previous error in the message box.

Last Message:
Redisplays the previous important message in the message box.Currently, only
the results of the BYTES command are redisplayed.

SYSTEM MENU: ---------------------------------------------------------------
Three programs are launched from this menu.Set the name and location of each
program in the config file.

Calculator:
Your favorite calculator program.

NewCLI:
Opens a new CLI (actually,an AmigaDOS shell) window.Type "endcli" in the win
dow to make it disappear.

Preferences:
Runs the Preferences program.

DISK MENU: -----------------------------------------------------------------
Fit:
Tells you whether the highlighted files and dirs in the active list will fit
in the inactive list. SID displays a message in the  message box telling you
whether the files will fit and how  many blocks you needed or have to spare.
This command takes into account the blocking factor of the device in the in-
active list.For example,the same group of files requires more room on a disk
(which can fit only 488 bytes per block) than  on a FastFileSystem hard disk
(which can fit 512 bytes per block).

COMMAND GADGETS: -----------------------------------------------------------
There are thirty command gadgets located in the bottom of the SIDwindow.Some
of the commands operate independently,but most of them act upon the highligh
ted files and directories in the active list.If you attempt to execute a com
mand on an invalid directory in the active list,an error message`ll be disp-
layed.The commands can be categorized by which files they act upon:

System Commands:
Do not act upon any files: MEMORY,TIME

List Commands:
Highlight or unhighlight entries in the list: ALL,NONE,PATTERN

Directory Commands:
Operate on the directory corresponding to the list: DISK,MAKEDIR

Single File Commands:
Operate on each  highlighted file  and dir in the active list one at a time:
COMMENT,EXECUTE,OTHER,RUN,XREAD,DELETE,HEAR,PROTECT,UNARC,DUP,INFO,READ,VIEW
EDIT,LISTARC,RENAME,XEDIT

Multiple File Commands:
Operate on highlighted entries in the active list all at once:
ARC,BYTES,PRINT,SET

Two List Commands:
Operate on both lists,moving files and dirs from the active list to the ina-
ctive list: COPY,MOVE

HIGHLIGHT METHOD: ----------------------------------------------------------
All highlighted entries in  the active list`ll be unhighlighted as a command
executes upon them (exception: the INFO command).If you stop the command be-
fore it can finish,all entries that it didn't get to will remain highlighted
Remember that you can rehighlight the files that were highlighted before the
execution of the previous command by  clicking on the Rehighlight Gadget for
that list.

INPUT REQUESTER: -----------------------------------------------------------
A white Input Requester will appear in the middle of the SID window for some
of the commands.The requester has a single field for input and can have eit-
her two or four gadgets:

Accept Gadget:
This gadget appears on the far left and will usually take the name of the co
mmand you are executing.Click on this to accept the data you have typed.

STOP! Gadget:
This gadget appears on the far right. Click on this to stop the command from
executing.The command will stop without executing upon the remaining highli-
ghted entries,if any.

PREVious Gadget:
This gadget will appear for single file commands.If enabled (not ghosted),cl
ick on this gadget to execute the  command on the previous highlighted file.
The current file will be ignored.

NEXT Gadget:
This gadget will appear for single file commands.If enabled,click on this ga
dget to ignore the current file and execute the command on the next highligh
ted file.

As with almost everything in SID,there are keyboard equivalents to the above
gadgets:

Accept Gadget ... press RETURN
STOP! Gadget .... press ESCape
PREV Gadget ..... press CTRL Left Arrow
NEXT Gadget ..... press CTRL Right Arrow

When entering filenames in the input requester,SID`ll reject blank or dupli-
cate names.

DIRECTORY REQUESTER: -------------------------------------------------------
Some commands such as COPY,DELETE,and BYTES operate on entire dirs.When such
a command is executed, a black Directory Requester will appear in the center
of the SID window.Each time a dir is entered by one of these commands,its na
me will appear in the requester. Since the Dir Requester  obscures the STOP!
requester,it has its own set of STOP! and PAUSE buttons that operate exactly
as they do on the STOP! requester.

ERROR REQUESTER: -----------------------------------------------------------
This orange requester will appear in the middle of the SID window when an er
ror occurs during the execution of a command.It has the following gadgets:

WHY? Gadget:
Will explain in the message box why the error occurred.

STOP! Gadget:
Will stop the command immediately,ignoring any remaining highlighted entries

CONTINUE Gadget:
Will skip over this file and continue executing the current command.

RETRY Gadget:
Will try to re-execute the command on the current file.

The keyboard equivalents to the gadgets are:

WHY? Gadget ....... 'W' key
STOP! Gadget ...... 'S' or ESCape key
CONTINUE Gadget ... 'C' key
RETRY Gadget ...... 'R' key

SYSTEM COMMANDS: -----------------------------------------------------------
MEMORY:
Will display the number of bytes of CHIP RAM,FAST RAM,and total RAM availab-
le on your system.

TIME:
Will display the current day, date, and time.

LIST COMMANDS: -------------------------------------------------------------
ALL:
A single click will highlight  all of the files in the active list. A double
click will highlight all files AND directories in the active list.

NONE:
Will unhighlight all files and directories in the active list.

PATTERN:
Will highlight entries in the active  list based on a pattern that you enter
in the Input Requester.This supports all AmigaDOS pattern matching wildcards

#c  - Matches any number of repetitions of the character 'c',including none.
      For example: TI#M matches TI, TIM, TIMM, and TIMMMMM

()  - Indicates that a group of chars is to be treated as a single character

?   - Matches any single character,NOT including none.For example:
      T?MMY matches TAMMY, TIMMY, TOMMY, but not TMMY

a|b - Matches either pattern "a" or pattern "b".For example:
      #?.(C|O) matches names ending in .C or .O

%   - Matches the NULL character.For example: DISK(S|%) matches DISK or DISKS

'   - Placed before a wildcardcharacter,the apostophe indicates that you want
      to match the next character,not use its wildcard abilities.For example:
      FILE'(?') matches FILE(1) and FILE(2) instead of FILE1

You can also combine wildcards to perform even more powerful pattern matching

#(group) - Matches any number of repetitions  of the the group  of characters
           enclosed in the parentheses,including none.For example:
           BOW#(WOW) matches BOW,BOWWOW,and BOWWOWWOW

#?       - Matches any number of repetitions of any character,including none.
           This is identical to the MS-DOS asterik wildcard.For example:
           #?.C matches any entry whose name ends in .C
           H#?D will match HD, HEAD, and HARVARD

(?|%)    - Matches any character or no character.For example:
           (?|%)ICK matches LICK, SICK, or ICK

The PATTERN button also supports the MS-DOS asterik wildcard:

*   - Matches any number of repetitions of any character,including none.This
      is the same as the AmigaDOS #? wildcard combination.For example:
      *.C matches any entry whose name ends in .C

Note that even though all of the above examples were presented in upper case
AmigaDOS is not  case sensitive, so "H#?" will match both "HI" and "hi". The
PATTERN command does NOT  unhighlight entries  which do not fit the pattern;
therefore,you can execute  this command a number of  times for multi-layered
pattern selections.

DIRECTORY COMMANDS: --------------------------------------------------------
DISK:
Displays a requester containing  information about the disk corresponding to
the active list:

NAME ..... disk name
SIZE ..... approximate storage size in K or MB
TOTAL .... total number of blocks and bytes
USED ..... number of blocks and bytes used
FREE ..... number of available blocks and bytes
FULL ..... percent full (0% = empty, 100% = full)
DENSITY .. storage density in the number of bytes per block
ERRORS ... number of errors recorded for this disk
STATUS ... either "Read/Write" or "Read Only" if write protected
DATE ..... format date
TIME ..... format time

Click the RMB to display the DISKrequester for the inactive list.Continually
clicking the RMB will toggle back  and forth between the active and inactive
list.Clicking the LMB or pressing any key will make the requester disappear.

MAKEDIR: -------------------------------------------------------------------
Creates a directory in the active list. You enter the name of the dir in the
Input Requester. You cannot specify a name that already exists in the active
list.You can also make a directory and load it at the same time.These make/-
load directory commands are accessible only from the keyboard.Pressing:
CTRL-< or CTRL-, Creates the dir you specify and loads it in the left list.
CTRL-> or CTRL-. Creates the dir you specify and loads it in the right list.

For example,if the left list is active and you press CTRL-<, the current dir
will be replaced with the directory you create.If you press CTRL->, however,
the directory you specify will appear in the left list,but will be loaded in
the right list.

SINGLE FILE COMMANDS: ------------------------------------------------------
COMMENT:
Allows you to attach a comment to the highlighted files and dirs in the act-
ive list.If a comment already exists for an entry, it will appear in the In-
put Requester,allowing you to edit or delete it. Unlike AmigaDOS, SID copies
comments along with their respective files,making the idea of a file comment
a little more attractive.You can view a file's comment with the INFO command

DELETE:
Deletes all highlighted files and directories.

Delete Requester:
After clicking on the DELETEgadget,a requester will appear asking you if you
are sure you want  to delete the  highlighted files. You can either click on
the DELETE gadget to delete the files,or the CANCEL gadget to cancel the DE-
LETE command.If you never make any mistakes,you can configure this requester
to not appear. You can also toggle it on and off during the program with the
Delete" item in the "Flags" menu.

Directory Delete Requester:
Each time the DELETE command encounters a non-empty directory, the Directory
Delete Requester  will appear asking you  if you are sure you want to delete
that directory.You can either click on the DELETE gadget to delete the speci
fied directory,or click on the CANCEL gadget to skip that directory.The DEL-
ETE command will continue with any remaining highlighted entries.You can al-
so configure this requester to not appear,or toggle it on and off during the
program with the "Directory Delete" item in the "Flags" menu.

DUP:
Duplicates all highlighted files  in the active list (but not directories at
this time).The Input Requester will appear with the name of each file selec-
ted,allowing you to enter a name for the duplicate file.You cannot specify a
name that already exists in the active list.

EDIT:
Loads the highlighted files into your favorite text editor or word processor
one at a time.You specify the name and path of your texteditor in the config
file.The size of the file is updated in the list to reflect any changes that
you may have made.

EXECUTE:
Executes the highlighted files in the active list with the AmigaDOS"Execute"
command.It is up to you to make sure that the  files you selected are indeed
batch files.

HEAR:
Plays digitized sound samples  with the play program that you specify in the
config file.

INFO:
Displays a requester containing information  about the highlighted files and
directories in the active list:

NAME ..... name of the file or directory
TYPE ..... either "File" or "Directory"
DATE ..... date file or directory was created
TIME ..... time file or directory was created
SIZE ..... size of file in bytes (0 for directories)
BLOCKS ... number of blocks occupied by file (0 for directories)
DESC ..... file description
STATUS ... file protection mask and set bits (see PROTECT command)
COMMENT .. file comment

PREV Gadget:
Displays the INFO requester for the previous entry in the list.

Next Gadget:
Displays the INFO requester for the next entry in the list.

STOP! Gadget:
Stops the INFO requester display.

As with all gadgets in SID,there are command key equivalents:

PREV Gadget ... press 'P'
STOP! Gadget .. press 'S' or ESCape
NEXT Gadget ... press any other key or click the  mouse anywhere else in the
                window with the  left or right mouse button except on top of
                the PREV or STOP! gadgets

LISTARC:
Lists in the READ window the contents of an archived file.SID reads the file
and automatically detects which archive program to use,either ARC or ZOO.You
specify in the config file  the name and paths used by each archival program
to list a  file's contents. Note that PAK and WARP currently do not have the
ability to list the contents of their files.If SID cannot identify the arch-
ival method used on a file, the Input Requester will appear, allowing you to
type in the program to use or to cancel the command.This is handy if you se-
lect a file that hasn't been archived or if you are trying to list the cont-
ents of a file archived by a new program such as ZIP.

OTHER:
This is a command that you  configure to your own liking. It operates on all
highlighted files in the active list.

PROTECT:
Allows you to set the protection bits for the highlighted files in the acti-
ve list.A requester will appear for each file,displaying the current protec-
tion mask for that file.AmigaDOS files have eight protection bits,though on-
ly half of them are currently supported.They are:

H - Hidden ..... similar to MS-DOS hidden files (not supported)
S - Script ..... batch file can be run as a program
P - Pure ....... program can be made resident
A - Archived ... file has not changed since the last backup
R - Read ....... file can be read (not supported)
W - Write ...... file can be written to (not supported)
E - Execute .... file can be executed (not supported)
D - Delete ..... file can be deleted

There are eight gadgets in the requester corresponding to the eight protect-
ion bits.Click on a gadget to change the state of that bit.You can click and
hold the LMB,then move the pointer over the other gadgets to change them all
to the state of the first bit on which you clicked. Or, click the RMB over a
gadget to change all of the bits  to that state. Both the current protection
mask and the new one that you select  appear at the bottom of the requester,
for example: Old: ----RWED        New: -S--RWED

You can revert back to the Old protection mask by clicking on the word "Old"
(or anywhere near it).

There are four more familiar gadgets:

PROTECT Gadget .... click to accept the pattern you've entered
PREVious Gadget ... ignore this file, go to previous file
NEXT Gadget ....... ignore this file, go to next file
STOP! Gadget ...... stop the PROTECT command

And the keyboard equivalents:

PROTECT Gadget .... RETURN
PREVious Gadget ... 'P' key
NEXT Gadget ....... 'N' key
STOP! Gadget ...... ESCape key

Note that these protection bits are preserved by the SID copy command.

READ:
Reads the highlighted files  in the active list. SID loads the file into its
own text reader.Binary characters are represented as dots.Tabs are currently
not represented. You can scroll the text by clicking on a gadget, pressing a
key,or simply clicking the mouse:

Up Arrow Gadget:
Click to display previous line.Click and hold to scroll.

Down Arrow Gadget:
Click to display next line.Click and hold to scroll.

Slider Bar:
Click to page forward or backward.Click and hold to scroll.

Up Arrow ........... previous line
Down Arrow ......... next line
SHIFT Up Arrow ..... previous page
SHIFT Down Arrow ... next page
ALT Up Arrow ....... top of file
ALT Down Arrow ..... bottom of file

Or you can just click the left mouse button anywhere in the window to scroll
the display.Click in the bottom half of the window to scroll toward the bot-
tom of the file,or the tophalf of the window to scroll toward the top of the
file.Scrolling slows down as you move the pointer toward the vertical center
of the window,until it finally reverses direction as you cross the center.

FONT Gadget,`F`-key:
Toggles between 77 and 125 character display.

PREVious Gadget,`P`-key:
Reads the previous highlighted file.

NEXT Gadget,Window Close Gadget,`N`-key:
Reads the next highlighted file.

STOP! Gadget,`S`-key,ESCape key:
Ends the READ command.

RENAME:
Renames highlighted files and directories in the active list.The Input Requ-
ester will appear for each entry with its current name in the input field,al
lowing you to edit it. You cannot specify a  name that already exists in the
list.

RUN:
Runs the highlighted programs in the active list.If you need to specify com-
mand-line arguments for the programs, be sure to click on the REQ gadget. If
you need to interact with the programs from the command line, be sure to run
the program in the foreground (see the "Run" item in the "Flags" menu).

UNARC:
Unarchives the highlighted files in the active list. SID reads each file and
automatically selects which archive method to use,either ARC,PAK,WARP,or ZOO
If SID cannot identify which archive method was used, the Input Requester`ll
appear,allowing you to specify the archive program or to cancel the command.
Once the file has been identified,a CLI window is opened,allowing you to wa-
tch the progress of the unarc program. When it has finished, SID will reload
the active directory to show the unarc'd files.You can unarc to the inactive
list by clicking on the arrow (Explore gadget) in the top  center of the SID
window. It will turn orange to indicate the "Explore Mode". In this mode,the
contents of all highlighted arc files in the  active list will be unarc'd to
the inactive list when you click on the UNARC gadget. The inactive list will
then be reloaded to reflect the newly unarc'd files.

VIEW:
Views IFF graphic files with your  favorite viewing program. You specify the
name and path of your view program in the config file.

XEDIT:
Loads the highlighted files into your favorite hex editor.You specify the na
me and path of the editor in the config file.The size of the file is updated
in the list to reflect any changes that you may have made.

XREAD:
Displays the contents of the highlighted files  in hexadecimal format as (in
truncated form):

       000030  69 63 65 20  6D ... 73  6F 75 72 63  ice misc.resourc

The XREAD command uses the same window as the READcommand,displaying sixteen
bytes per line.The ASCII repesentation of those characters are listed in the
far right. Again, binary characters are replaced with a dot. The hexadecimal
equivalent of each character is listed in the middle,separated into fourbyte
groups. The six-digit number on the left is  the address in hex of the first
character in that line.

MULTIPLE FILE COMMANDS: ----------------------------------------------------
ARC:
Creates an archived file containing all of the highlighted files in the act-
ive list.You select the archive method to be used in the "Archive Method" i-
tem in the "Flags" menu. The Input Requester will appear asking you to enter
the name of the archive file.

BYTES:
Counts the number of bytes  in the highlighted files  and dirs in the active
list.If a dir is highlighted,the files and subdirs contained in that dir are
also counted. See the "Bytes" item in the "Flags" menu  for the two counting
methods possible with this command.

PRINT:
Prints all highlighted files with your favorite print program.The program mu
st be able to accept multiple files.In the config file,prefacing the name of
the print program with "run" will cause the files to be printed in the back-
ground,allowing you to use SID immediately after executing the PRINT command
If you don't do this,SID will sleep until all the files have printed.

SET:
Allows you to set or unset protection bits for  all of the highlighted files
in the active list.The requester which appears is similar to the PROTECT re-
quester,except that each bit gadget has three states instead of two.For exa-
mple,in the case of the Script gadget:

NOT SCRIPT ... turn off the script bit (-)
SCRIPT ....... turn on the script bit  (S)
ignore S ..... ignore the script bit   (*)

In the protection  mask,a bit that is on is  represented by the first letter
of its name, a bit that is off is represented by a hyphen, and a bit that is
to be ignored is represented by an asterisk. Instead of allowing  you to set
the protection for  each highlighted file  one at a time as with the PROTECT
command,the SET command sets the protection for all of the highlighted files
at once. For example, to archive all highlighted files and protect them from
deletion,you would choose the mask: ***A***-

Note that the Archive bit will be set,the Delete bit will be cleared,and all
other bits will be ignored. Otherwise, the operation of the SET requester is
identical to the PROTECT requester.

TWO LIST COMMANDS: ---------------------------------------------------------
COPY:
Copies highlighted files and dirs from the active list to the inactive list.
The dir in the inactive list does NOT  need to be loaded to copy files to it
Unlike AmigaDOS,files and dirs copied with SID retain their comments and pro
tection bits.

MOVE:
Moves  highlighted files (but not dirs at this time) from the active list to
the inactive list.If both directories are on the same device, SID`ll use the
Rename command to move the files, speeding up the operation considerably. If
the dirs are on different devices, SID`ll copy the files from the source dir
to the destination dir, then delete the files in the source dir. Files which
already exist in the destination dir are not moved and`ll remain highlighted

COMMAND-KEY EQUIVALENTS: ---------------------------------------------------
There are keyboard equivalents for many of the SID commands.They are:

CTRL-A .... ALL
CTRL-D .... DISK
CTRL-E .... EDIT
CTRL-I .... INFO
CTRL-M .... MAKEDIR
CTRL-N .... NONE
CTRL-P .... PATTERN
CTRL-R .... RENAME
CTRL-S .... SHRINK

Plus a few other goodies:

CTRL-UpArrow ....... load parent of active list
CTRL-LeftArrow ..... rehighlight left list
CTRL-RightArrow .... rehighlight right list
SHIFT-LeftArrow .... make left list active
SHIFT-RightArrow ... make right list active
LeftArrow .......... move cursor to left path field
RightArrow ......... move cursor to right path field

FLAG GADGETS: --------------------------------------------------------------
Located in the title bar of the SID window, each gadget represents the state
of a configuration flag.The flag is "on" if the gadget is highlighted (black
with orange letters),and "off" if the gadget is unhighlighted (white with bl
ue letters).The initial state of these flags upon program startup can be set
in the config file.

REQ Gadget:
If highlighted,the Input Requester will appear for each command you execute,
allowing  you to change the command or  its arguments. The text you enter in
the requester will be saved for the next time you execute that command. This
can be handy for  temporarily changing a command  without having to edit and
reload the config file.

OUTPUT Gadget:
If highlighted,a CLI window will open for every program you run from SID,al-
lowing you to view the output from that program.This includes programs laun-
ched by commands such as ARC,UNARC,VIEW,etc. The OUTPUT option is handy when
you run SID from the Workbench,as there is no CLI window in which the output
will be displayed.

FLAG MENU: -----------------------------------------------------------------
A number of other configuration flags can be toggled in the "Flag" menu. The
initial values upon program startup  of these flags are also configurable. A
check mark appears next to the flag's current value.

Archive Method:
The archive method that you wish to use to archive files with the ARCcommand
You can select from ARC,PAK,WARP,and ZOO.

BYTE COUNT:
Actual:
The BYTES command will display the actual number of bytes in the highlighted
files and dirs.This is calculated by just summing the size of each file sel-
ected.The dirs themselves are ignored, but the files within highlighted dirs
are added to the count.

Occupied:
The BYTES command will display the number of bytes the highlighted files and
dirs  occupy on the disk. This takes into account the blocking factor of the
disk (the number of bytes that can fit into each block). This will be larger
than the figure you would get with the Actual selection because each file re
quires one block for its directoryheader,and each file requires a whole numb
er of blocks even though it may not entirely fill up the last block,and each
dir requires one block for its entry.

COPY:
Overwrite:
Will overwrite existing files in the destination dir when you copy files wi-
th the COPY command.

Only New:
Will only copy files which do not exist in the destination dir. Uncopied fi-
les will remain highlighted.

Delete:
Whether or not the Delete  Requester will appear each  time you click on the
DELETE gadget.The Delete Requester asks you if you are sure you want to del-
ete the selected files (see DELETE command).It's handy to be able to prevent
the requester from appearing during sessions where you do alot of deleting.

Directory Delete:
Whether or not the Directory Delete requester will appear for each non-empty
directory selected for deletion  by the DELETE command. The Directory Delete
requester asks you if you are sure you want to delete the specified dir (see
DELETE command).

Error Stop:
Whether the Error Requester will appear for errors which occur during the ex
ecution of commands.

Path:
Whether the dirname will be replaced with its absolute path name.For example
DF1:would be replaced with the name of the disk,such as "Workbench1.3:".When
you have two diskettes with the same name,SID cannot distinguish between the
two,and therefore you would need to turn off the absolute path and reference
the disks by device,such as DF0: and DF1: In this case,you would need to se-
lect the "As Specified" subitem.

Run:
Whether programs launched from SID using the RUN command will be launched in
the background or foreground.

Background:
Immediately frees SID for further use.

Foreground:
SID sleeps until the launched program has finished executing.Use this option
along with the OUTPUTwindow to interact with a program that requires command
line input.

LIMITS: --------------------------------------------------------------------
There are no physical limits to this program. SID supports an unlimited num-
ber of files per directory and an unlimited directory depth.Everything is dy
namically allocated as needed to conserve memory and to eliminate restricti-
ons.However,there are some AmigaDOS restrictions which limit SID:

      File Name .......... 30 characters  (enforced in AmigaDOS v1.3)
      File Comment ....... 70 characters
      Path Name .......... 255 characters (curse that BCPL!)
      AmigaDOS Command ... 255 characters

KNOWN PROBLEMS: ------------------------------------------------------------
SID has problems with early versions of TxED and NewZAP. This has to do with
the non-standard parsing routines these programs used.These problems`ve been
corrected with TxED Plus  and the newer version of NewZAP, as SID works fine
with these.Also,I know for a fact that many  features do NOT work with Work-
bench v1.2.You must be using WB v1.3 to use SID! A number of people have com
plained about the size of SID. In the early days of development as SID began
to grow, I had to decide just who my target  audience was going to be. Since
there were already a number  of good,small DU's available, I decided to make
create SID  especially for power users, for whom 100K of disk space and 200K
of RAM is a drop in the bucket (though I do know some 512K/single-drive peo-
ple who are using SID!)

COMING SOON TO A THEATRE NEAR YOU: -----------------------------------------
There are a number of features still on the drawing board for SID.Registered
users`ll be notified when these changes have been made and will be given the
opportunity to acquire major upgrades long before they are available nation-
ally.Planned features include:

-- MOVE and DUP directories
-- search disks for a specified file
-- search files for a specified string
-- copy, edit, erase, format, and rename disks
-- create empty files for editing
-- compare and sort files
-- blitter-based text in the READ window
-- pattern string search in the READ window
-- horizontal scrolling in the READ window
-- macros and a command recorder for repetitious operations
-- ARexx interface
-- interactive configuration editor

  If there's something else you'd like to see, please let me know!

                       SID Docs v1.04       09/24/89
                       © Copyright 1989  Timm Martin
                       All Rights Reserved Worldwide



CONFIG.DOC: ----------------------------------------------------------------
This file describes in detail the setup,operation,and maintenance of the SID
configuration file.You can completely customize SID to your needs and envir-
onment with the configurationfile.Because the configuration changes as often
as SID does,I've opted to place the instructions in this separate file. This
file assumes you have read the SID.docs and have used SID enough to be fami-
liar with the terms describing the SID functions.

WHY THE CONFIG FILE IS NEEDED: ---------------------------------------------
SID will run on its own without the configuration file,though you will be re
stricted to using the defaults that are hardcoded into the program.I must ad
mit that I set these up for my system, but hopefully you will find that many
of these defaults`ll suit you as well.Of course,once the program is running,
any of these default settings may be changed.In all likelihood,however,there
will be some defaults that you will need to alter.This is where the configu-
ration file enters the picture.This file should contain all SID settings wh-
ich differ from the hardcoded defaults.

NAME AND LOCATION OF THE CONFIG FILE: --------------------------------------
The SID config file must be named SID.config and placed in the s: directory.
The s: directory is automatically assigned to the 's' directory on your boot
disk, though hard disk users often assign s: to a directory in the Workbench
partition of their hard drive.Whatever the case,be sure place the configfile
there,or SID will not find it.

If you are handy with your hex file editor, however, you can change the name
and location of the config file.Do a search on the name "s:SID.config" (with
out the quotes).I've provided up to 30 characters in which to write the ent-
ire name (including the absolute path) of the SID config file.SID will auto-
matically strip any trailing blanks. Be sure you do not overwrite that final
NULL,or nasty things will happen.Also,do not attempt this unless you are ad-
ept at this kind of thing.

LOADING THE CONFIG FILE UPON STARTUP: --------------------------------------
SID automatically attempts to load the config file upon startup.No error mes
sage is displayed if SID does not find your config file.Entries found in the
config file will overwrite  the corresponding default settings, meaning that
only entries which differ from the default settings should be included in yo
ur config file.That way,SID will load the fastest possible.

EDITING THE CONFIG FILE: ---------------------------------------------------
You can edit the config file with any ASCII text editor.Just load the config
file into your favorite editor + enter the keywords  and values as described
below.I'm using the text-file configuration method so that almost anyone can
create and maintain their config file.Eventually I plan to release an inter-
active configuration editor which will not only explain in detail the meani-
ng of each keyword inside the program,but will also interactively prompt you
for the desired values.Registered users`ll be  notified when this program is
available.

You may also edit the config file from within SID by selecting the "Edit" su
bitem from the "Configuration" item in the "Program" menu.

FORMAT OF THE CONFIG ENTRY: ------------------------------------------------
The standard format of  an entry in the  config file is "Keyword=value". The
"keyword" is name of the setting that you`re changing.This must be specified
EXACTLY as listed in the docs for SID to recognize it,meaning that there can
be no imbedded blanks and that case (upper and lower) is important. The key-
word is then immediately followed by an equal sign.Everything from the equal
sign to the end of the line (not including the equal sign or the end-of-line
character) is considered to be part of the value.For example,consider the fo
llowing entry: "Preferences=sys:system/Preferences".The keyword is "Preferen
ces",meaning that you want to change the setting for the Preferences command
Note that  the first letter is  capitalized exactly  as listed later in this
doc file.The value is "sys:system/Preferences",meaning,in this case,that SID
can find the Preferences program in the "system" directory on the "sys:"disk

ENTRIES IN THE CONFIG FILE: ------------------------------------------------
The entries in the config file are divided into four categories based on the
values they require: flags,numbers,strings,and keys. Flags require YES or NO
values,numbers require numerical values, strings require text string values,
and keys require  specific key values. The default value for each keyword is
listed in parentheses.

FLAG ENTRIES: --------------------------------------------------------------
All of the flag keywords require a YES or NO value.Note that these values mu
st be capitalized and should not include any preceeding,imbedded,or trailing
blanks.

AbsolutePath=(YES is default)
Whether the path name`ll be converted to its absolute path name.For example,
the pathname "c:" may be converted to its absolute pathname "Workbench1.3:c"
Note that even if this flag is set to NO,if you enter a blank directory (wh-
ich`ll give you the current directory),its absolute pathname`ll be displayed

BytesOccupied=(YES is default)
Whether you want the BYTES command to display the number of bytes the highli
ghted files occupy (YES) or the number of actual bytes in the files (NO).

CopyOverwrite=(YES is default)
Whether you want to overwrite existing files in the destination directory wh
en you copy files.If YES,all highlighted files will be copied to the destina
tiondirectory,regardless of whether they exist.If NO,only the files which do
not exist in the destination directory will be copied.Uncopied files will re
main highlighted.You can toggle this flag on and off from within SID by usi-
ng the "Flags" menu.

DeleteCheck=(YES is default)
Whether a requester will appear at the beginning of each delete command,ask-
ing you if you are sure you want to delete the highlighted files.This is dif
ferent than DirDelete because this keyword causes a requester to appear only
once everytime you execute the DELETE command, whereas the DirDelete keyword
causes a requester to appear for each directory selected for deletion.

DirDelete=(YES is default)
Whether a requester should  appear every time  you try to delete a non-empty
directory,asking you if you`re sure you want to delete that directory.Though
this can be annoying at times,it`ll save you  from the possible catastrophic
results of deleting an entire directory you wanted to save.

EnglishDates=(YES is default)
Whether file dates in the DATE  and TIME entry display  will be displayed in
English for recent dates (such as "Today","Yesterday","Tuesday",etc.)If this
is NO,all dates will be displayed in the MM/DD/YY format.

ErrorStop=(YES is default)
Whether the Error requester  will be displayed when  SID encounters an error
while trying to perform a command.This allows you to retry the file,skip the
file,or stop the command altogether.If you don't wnat to be bothered each ti
me a command fails,set this flag to NULL.The files for which a command fails
will be left highlighted after the command has finished executing.

QuitCheck=(NO is default)
Whether a requester will appear when you click on the window close gadget as
king you if you are sure  you want to quit. This is provided for people with
itchy trigger fingers.

ReadTiny=(NO is default)
Whether the READ window displays  the file in the tiny  text (YES) or in the
normal Topaz80 text (NO).This may also be changed in the program by clicking
on the FONT button in the READ window's title bar.

Requester=(NO is default)
Whether a requester will appear for each  command allowing you to change the
command or its arguments. You can toggle this  on and off by clicking on the
REQ gadget located in SID's window title bar.The text you enter in the reque
ster will be saved for the next time you execute that command.This can be ha
ndy for temporarily changing a command without having to edit and reload the
config file.

ShowOutput=(NO is default)
Whether a CLI window will appear for every program you run from SID,allowing
you to view that program's output. This can be toggled on and off later with
the OUTPUT gadget in the SID window's title bar.Note that if you are running
SID from the CLI window,the output of programs launched from SID will be dis
played in that CLI window anyway.

Wait=(NO is default)
Whether programs launched with the  RUN command will be interactive (I know,
"Wait" is a funny name,but you'll see my logic).If Wait=NO,then a program la
unched with the RUN command will be run in the background, and SID can go on
about its business (the program is launched asynchronously, for all you tech
buffs). The problem with this is that the program`ll not be interactive from
the CLI.If Wait=YES,then the program will  be run in the foreground, meaning
SID`ll wait until the program finishes. The advantage of this method is that
the program is interactive in the CLI, allowing you to enter input if it's a
command-line-based program. Note that this option works only when the OUTPUT
window option is also specified.

WindowStay=(YES is default)
When you change the size of the SID window, if WindowStay=YES,S ID will save
the window's location in  the Workbench screen so that if you ever return to
that size window,it will be right where you left it last.If WindowStay=NO,ho
wever,then the window will always be placed in the position according to the
config values.

VALUE ENTRIES: -------------------------------------------------------------
These keywords require numerical value.Invalid ones`ll be corrected/ignored.

FullLeft=(0 is default)
This is the left edge of the Full window.

FullTop=(0 is default)
This is the top edge of the Full window.

HalfLeft=(0 is default)
This is the left edge of the  Half window. Note that on a standard Workbench
screen,a left edge value other than  zero for all but the Shrink window will
be meaningless since both the SID window and the Workbench screen are the sa
me width.This value was placed here for future expansion (I'm sure we'll all
have a 1024 x 1024 monitor some day) or for vScreen users ("BigSID").

HalfTop=(0 is default)
This is the top edge of the Half window.

LaceLeft=(0 is default)
This is the left edge of the Lace window.

LaceTop=(0 is default)
This is the top edge of the Lace window.

OutputHeight=(120 is default)
This is the height of the CLI output window.

OutputLeft=(0 is default)
This is the left edge of the CLI output window opened when programs are laun
ched from SID and the ShowOutput flag is on.

OutputTop=(80 is default)
This is the top edge of the CLI output window.

OutputWidth=(640 is default)
This is the width of the CLI output window.

ShrinkLeft=(344 is default,which will place the shrink window flush right wi
th the Workbench screen).This is the LeftEdge of the Shrink window.

ShrinkTop=(0 is default)
This is the TopEdge of the Shrink window.

SpecifyLeft=(0 is default)
This is the left edge of the Specify window.

SpecifyRows=(10 is default)
This is the number of rows with which the specify window`ll open. This value
is only used if you specify WindowHeight=SPECIFY.

SpecifyTop=(0 is default)
This is the top edge of the Specify window.

STRING ENTRIES: ------------------------------------------------------------
These are the strings used to execute the commands.Everything from the equal
sign after the keyword to the end of the line, including imbedded / trailing
blanks,will be recognized.

Arc=(c:arc a is default)
The Arc program you use for archiving files.Notice that four different arch-
ival methods are supported: Arc, Pak, Warp,and Zoo.Therefore,this value shou
ld contain the command to summon the Arc program,not the Pak,Warp,or Zoo pro
gram.They have their own separate keywords,as shown below.

Button1=
Button2=
Button3=
Button4=
Button5=
Button6=
Button7=
Button8=

(The default is NOT to list them in the config file).The eight Button keywo-
rds listed above correspond to the eight device  buttons associated with the
two directory lists (see the DeviceButtons= keyword).The Button1= keyword co
rresponds to the leftmost device button,Button8= to the rightmost,and so on.
If a device button has a  button path specified, then instead of appending a
colon to the button name,the button path is used. That means you must supply
any necessary colons and slashes.That also means that the button name is ig-
nored and you can name it anything you want.Note that you do not have to spe
cify a button path for each device button.For example,using the DeviceButto-
ns= keyword default, the third button is named DH0. Instead,you could change
the name to WKB (with the DeviceButtons= keyword),and set the path with But-
ton3=Workbench1.3:

Calculator=(c:calculator is default)
The name and location of the calculator program that you like to use.

DiskEdit=(c:DiskX is default)
The name and location of your favorite disk editor. This is not supported by
the current version of SID.

Execute=(there is no default)
The arguments for batch files  executed from SID. Though this will likely be
blank for most users,you may find sometime that  you are often executing the
same batch file which requires a certain set of arguments.

FileEdit=(c:ue is default)
The name and location of your favorite ASCII text editor.

FileXEdit=(c:newzap is default)
The name/location of your favorite hex editor that allows you to edit binary

Hear=(c:hear is default)
The name and location of the program you use to play digitized sounds.

ListArc=(c:arc l is default)
The Arc program you use for listing the contents of arc'd files.

ListPak=(there is no default)
The command you use for listing the contents of pak'd files. Even though the
current version of the Pak program  does not have the ability to display the
contents of pak'd files,this was provided for upward compatability.

ListWarp=(there is no default)
The Warp program you use for listing the contents of warp'd files. Note that
the current version of the Warp  program does not have  a command to display
the contents of a warp'd file.This was provided for upward compatability.

ListZoo=(c:zoo l is default)
The Zoo program you use for listing the contents of zoo'd files.

NewCLI=(c:NewSHELL "NEWCON:0/0/640/96/Type ENDCLI to Quit" is default)
The command used to create a new CLI window.Note how I am using the Shell pr
ovided with Workbench 1.3 in the default.

Other=(c:cc is default)
This is a user-definable key which you can set to do anything you want.

Pak=(c:pak is default)
The Pak program you use for archiving files.

Pattern=(#?.c is default)
The first time you run the PATTERNcommand (which highlights all files in the
active list based on the AmigaDOS wildcard pattern you specify),this pattern
appears in the requester.

Preferences=(sys:system/Preferences is default)
Where to find the Preferences program.

Print=(c:print is default)
The name and location of the program you use to print files. A file printing
program with C source is included on the disk  of goodies sent to registered
SID users.

Run=(there is no default)
The arguments for programs run from SID.Though this will likely be blank for
most users,you may find sometime that you are often running the same program
which requires a certain set of arguments.

UnArc=(c:arc x is default)
The Arc program you use for unarchiving arc'd files.

UnPak=(there is no default)
The program you use for  unarchiving pak'd files. For the current version of
the Pak program, just typing the name of the pak'd file`ll cause it to unpak
itself,therefore no command needs to be specified.

UnWarp=(c:warp write is default)
The Warp program you use for unarchiving Warp'd disks.

UnZoo=(c:zoo x is default)
The Zoo program you use for unarchiving zoo'd files.

View=(c:superview -c is default)
The name and  location of your  favorite IFF graphic display program. Notice
that you can attach programarguments.In this case,I added a "-c" argument to
surpress color cycling.

Warp=(c:warp read 0 79 is default)
The Warp program you use for archiving disks.

Zoo=(c:zoo a is default)
The Zoo program you use for archiving files.

SPECIAL ENTRIES: -----------------------------------------------------------
These keywords require one of the special flags listed.

ArchiveMethod=(ARC is default)
This flag allows you to specify which archive method you want to use when ar
chiving files.You can specify:ARC to use Arc,ZOO to use Zoo,WARP to use Warp
and PAK to use Pak.Of course,you can change this at any time with the "Arch-
ival Method" item in the "Flags" menu. Also,this flag has nothing to do with
unarchiving or listing the contents of archived files.SID automatically det-
ermines which archival method to use in those cases.

ArrowDirection=(FLOW is default)
The direction in which the arrow (in the center of the SIDwindow) will point
If ArrowDirection=FLOW, the arrow`ll point in the direction of fileflow,i.e.
from the active side to the inactive side.If ArrowDirection=ACTIVE,the arrow
will point to the currently active side. Requires one of the following: FLOW
or ACTIVE

DeviceButtons=(DF0DF1RAMRADDH0DH1DH2DH3 is default)
These are the names of the eight device buttons which appear under each win-
dow.Notice how they are listed in succession with no imbedded blanks.The co-
lons are implied and  will be added by SID. Each button name must be exactly
three characters long,and you must specify all eight button names or strange
things will happen. You can override the directories loaded when clicking on
the device buttons by specifying alternate path names with the Button1=,But-
ton2=,etc. entries.See those keyword definitions below for more information.

EntryType=(SIZE ONLY is default)
The manner in which the entries will be displayed.Requires one of the follow
ing:SIZE ONLY     = just the size; this is by far the fastest method
    DATE AND TIME = also displays file creation date and time
    DESCRIPTION   = displays the description of the file

ScreenType=(WORKBENCH is default)
The screen on which the SID window will open when the program begins.Requires
one of the following:
    CUSTOM ...... SID will open on its own non-interlaced custom screen
    INTERLACE ... SID will open on its own interlaced custom screen
    WORKBENCH ... SID will open on the Workbench screen

Set=(*******- is default)
The protection bit pattern used by the SET requester.This string should be ei
ght characters long,each character representing the  bit in the corresponding
protectionstring HSPARWED.A letter indicates that the bit is to be set,a dash
(-) indicates that the bit is to be cleared,and an asterisk (or any other cha
racter) indicates that the bit is to be ignored. Thus, the default setup will
ignore all but the  Delete bit which`ll be cleared,meaning if you execute the
SET command without changing the bit pattern, all highlighted files will have
their Delete bits cleared (making them Not Deletable).

WindowHeight=(FULL is default)
The size at which SID's window will open when the program begins.Requires one
of the following:
FULL .... SID`ll open with a 640x200 pixel window, if possible
HALF .... SID`ll open with a 640x100 pixel window
LACE .... SID`ll open with a 640x400 pixel window, if possible
SHRINK .. SID`ll open shrunk
SPECIFY . Open SID with number of rows specified with the SpecifyRows keyword



UPDATES FOR SID V1.06: -----------------------------------------------------
- The Delete Requester now appears under the active list.
- Clicking SHRINK while on the custom screen will iconify the window.
- There is a different method for starting SID in shrink mode.
- You can specify the window and screen when starting in shrink mode.
- The MAKEDIR command can create corresponding drawer icons.
- The partial load message is no longer displayed.
- You can separate dirs and files in the directory lists.
- You now need to double-click directories while in explore mode.
- The file comment in the INFO requester is formatted.
- You can configure directories to be automatically loaded upon startup.
- The "Flags" menu allows extended selection.
- You can automatically load the directory of a diskette upon insertion.
- Dates can be displayed in Month/Day/Year or Day/Month/Year format.
- Lists remain "anchored" after commands.
- Select entries by date.

                                               ...plus a bunch of bug fixes!

DETAILS: -------------------------------------------------------------------
The Delete Requester now  appears under the active list. This has been added
to prevent something I've done more times than I care to admit: highlight fi
les in both lists,execute the  DELETE command, and accidentally delete files
in the wrong list because I didn't notice which list was highlighted.Now,wh-
en you click on the DELETE button,the Delete Requester will appear under the
active list containing the files to be deleted. It's placed at such a height
that you can see the entire list,and the DELETEbutton in the requester is at
the same height as the DELETE commandbutton in the SIDwindow.This may take a
while to get used to it,but after a couple of days,I found I really liked it

Clicking SHRINK while on the custom screen will iconify the window.If you cl
ick the SHRINKbutton while SID is on the custom or interlace screen,SID will
iconify itself on the  Workbench screen. Then clicking on EXPAND will return
SID to its same size on the same screen (custom or interlace).Thanks to Dan-
iel Schwartz for this suggestion.

There is a different method for starting SID in shrink mode: To start SID in
shrink mode, instead of setting WindowHeight=SHRINK in  the SID.config file,
you need to set the flag BeginShrunk=YES.The default is NO.Why? See #4.

You can specify the window and screen when  starting in shrink mode. Because
SID uses a separate flag(as indicated in #3) to begin shrunk,you can now spe
cify the desired window height and screen that SID should use once you click
on the EXPAND button.Previously,if you started shrunk,SID would always go to
a full size window on the Workbench screen when you clicked on EXPAND.

The MAKEDIR command can create corresponding drawer icons. You can configure
the MAKEDIR command to create a corresponding drawer icon by setting the SID
.config stringflag MakeDirIcon= to the name of the icon that you wish to use
The default is to have no icon created.For the corresponding icon to be cre-
ated,you must specify a valid file name,and the name of the directory you cr
eate must be 25 characters or less  so that the .info extension may be added
to the file name.

I've done it this way so that you are not forced to live with the drawericon
image that I choose. I suggest that you place the .info file you want to use
somewhere safe,such as the s: directory,perhaps naming it "SID.icon".If that
is the case,you would set the flag in the config file to read:

MakeDirIcon=s:SID.icon

Note that the directory icon will inherit all of the characteristics of your
MakeDir icon, such as position (if you've done a snapshot on it), protection
bits,comment (if any),etc.

The partial load message is no longer displayed. Previously,when you clicked
on the STOP! button while loading a directory, a message would appear saying
you've only partially loaded the directory.However,the message was displayed
so quickly that it was of little use.It has been removed.The general consen-
sus among SID experts is that if you click on the STOP! button,you should re
alize that in all likelihood the directory displayed will  only be a partial
representation.

You can separate dirs and files in the directory lists.By setting the SID.co
nfig flag SeparateDirs=YES, the dirs and files`ll be displayed separately in
the directory lists with the directories on top and the files on the bottom.
The default for this flag is NO (in other words,mix the files and dirs,sort-
ing them alphabetically).Thanks to Richard Richardson for this idea.NOTE: To
use this feature,you cannot load directories which contain dir names that be
gin with an alternate character (such as ß, or any character with a value be
tween 0x80 and 0xFF). Such entries will be displayed correctly, but you will
not be able to access them.

You now need to double-click directories while in explore mode. To load dirs
into the inactive list while in the explore mode (the flow arrow is red),you
need to double click on the desired directory, instead of just clicking once
as before. This is not only more consistent with the rest of the program, it
also allows you to work on directories in the activelist while in explore mo
de.Thanks to David Head for this idea.

The file comment in the INFO requester is formatted.In the INFO requester,if
a file comment extends to a second line,SID will attempt to end the first li
ne on a blank instead of in the middle of a word.This makes the comments mu-
ch easier to read.

You can configure directories to be automatically loaded upon startup.If you
always seem to be loading the same  directory(ies) when running SID, you can
now configure two directories to be automatically loaded upon startup.SID wi
ll automatically load the directories specified with the two SID.config str-
ing keywords AutoDir1= and AutoDir2=.For example,by setting:

        AutoDir1=-c
        AutoDir2=ram:

SID will automatically load the current directory into the left list and ram:
into the right. The default is no keyword,meaning that no directories will be
loaded. NOTE : You don't have to specify both AutoDir1 and AutoDir2 together,
meaning you can also load just a single directory.You can override the confi-
gured dirs by specifying your own directories  to be loaded as arguments from
the CLI.For example,if you enter:

        SID devs:

SID will load devs: into the left list, and then automatically load ram: into
the right list because of your configuration.If you don't want any dirs load-
ed,specify an argument of "-n" (without the quotes).

The "Flags"menu allows extended selection.This means that you can change more
than one flag in the "Flags" menu with a single press of the right mouse but-
ton.To do this,click and hold the right mouse button, then use the left mouse
button to select the desired flags.Release the right mousebutton when you are
finished.

You can automatically load the directory of a diskette upon insertion.By set-
ting the new SID.config flag LoadDiskette=YES,the rootdirectory of a disk wh-
en inserted into any drive will automatically be loaded into the active list.
This feature is handy when you want to scan a bunch of diskettes.There`re two
ways to automatically load disk directories.You can continuously load dirs in
to the same list (the active one), or alternate lists (swap the active status
after each load).If the new SID.config flag LoadSwitch=YES (and LoadDiskette=
YES),the directory of an inserted diskette`ll load into the active list, then
the inactive list will be made the active list.This means the diskette direc-
tories will be loaded alternating left and right.This can also be selected fr
om the "Load/Switch" option in the "Diskette" item of the "Flags" menu. While
SID is automatically  loading the directory of one diskette, you can insert a
diskette into another drive --the "disk inserted" messages are queued.It's di
rectory will be loaded as soon as the current load is completed or you termi-
nate it with the STOP! button.If LoadSwitch=NO (and LoadDiskette=YES),however
the directory of an inserted diskette will always be loaded into the same li-
st (the active one). This can also be selected from the "Auto Load" option in
"Diskette" menu item.If LoadDiskette=NO, however,the directory of an inserted
diskette will not be loaded (regardless of the setting of LoadSwitch).You may
make selection this with the "Ignore" option in the "Diskette" menu item.Tha-
nks to Daniel Schwartz for this idea,and my beta testers for its refinement.

Dates can be displayed in Month/Day/Year or Day/Month/Year format.Setting the
SID.configflag DateMDY=NO will display all dates in Day-Month-Year format.The
default is DateMDY=YES,which will display dates in Month-Day-Year format.

Lists remain "anchored" after commands. Previously, after executing a command
which changed a directory list (such as RENAME, COPY, DELETE, etc.), the list
would be redisplayed beginning with the first entry.Now the list remains "an-
chored" as much as possible in the same position.

Select entries by date.You can highlight entries by date in the activelist by
selecting the "Select by Date" item in the "File" menu.The input requester wi
ll appear allowing you to type in the date range.SID is looking for two argu-
ments,each separated by at least one blank,and each containing no imbedded bl
anks.The first argument is the "from" date, and the  second argument the "to"
date.Both arguments are inclusive,meaning all entries (files and directories)
greater than or equal  to the "from" date and less  than or equal to the "to"
date will be highlighted. Similar to the PATTERN command,this only highlights
entries--no unhighlighting is done (in other words, already highlighted files
which don't fall within the specified dates  will not be unhighlighted). This
means that  you can multiply select entries in a number of different ways--by
pattern,by date,or by manually clicking on them. This command`ll accept dates
in one of three formats:

English dates:
You can spell out the days such as "Today","Yesterday","Monday","Tuesday",etc
Only the first three characters are checked,so you can just as easily specify
"tod","yes","mon",etc.Case is not important.Note that the days you specify a-
re prior to the current day.For example,if today is Wednesday and you specify
"Tuesday", this really means yesterday, and not next Tuesday.Also,if you were
to specify "Weds",this would give you one week ago today--not today.To get to
day,you must explicitly specify "today" (or "tod").

AmigaDOS dates:
This is the dd-mmm-yy format that AmigaDOS uses, where "dd" is the day in nu-
meric digits,"mmm" is the first  three characters of the month name (case not
important),and "yy" is the  last two digits of the year (such as "89" for 19-
89).Note that you do not have to specify a leading zero if the day is less th
an 10.You may also omit the year if you want the current year.

Actual dates:
This is the mm/dd/yy format (or dd/mm/yy format if you set the new configflag
DateMDY=NO).You can use the slash,period,hyphen,or comma as a date separator,
or use no separator at all.The leading zero for the month is not required,and
if you omit the year,the current year will be assumed.You may also select all
dates prior to a given  date by specifying a  hyphen (-), "upto" (as with the
AmigaDOS "list" command),or "to" as  the first argument.For example,"to 11/4/
89" will highlight all entries dated on or before November 4, 1989.You may se
lect all dates after a given date by specifying a hyphen as the first argume-
nt or the word "since" (again as with the "list" command) as the first argum-
ent.For example,"sin yes" will higlight all entried  created since yesterday.
As another example,"10-jun-89 -" will highlight all entries created on or af-
ter June 10,1989.

CTRL-Y is the keyboard equivalent for this command.